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Preface 


This summary helps you use the interactive commands 
and facilities available on the OS/3 operating system. 
Included are: 


a All the commands you may enter from a 
workstation 


t Editor commands 
. Information on: 
- Entering information from a workstation 


- Command conventions used in this manual 


a Logon and {CAM _ terminal — sign-on 
@ procedures 


- Initiating the various interactive facilities 
) (such as job control dialog) 


- Function keys 


- Use of various types of terminals as 
workstations 


pe ee eee ee 
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To use this summary most effectively, you should order 
the binder (UP-8573) and the easel (UP-8573.1) from 
your Sperry representative. To assemble, open the 
binder and open the rings. Hook the folded vinyl! easel 
onto the rings on the right-hand side. The shorter flap 
of the easel (the side without punched holes) should lie 
against the back cover of the open binder. Place the 
pages of the book on the rings on the left-hand side. 
The first page of the book should rest against the 
inside front cover of the binder. Close the rings. Lay the 
book flat on your desk or workstation so that the long 
side of the book is facing you. Unfold the easel so that 
it forms a triangle with the back cover of the book. 
Now raise the pages of the book against the easel. You 
can now flip down through the book, guided by the 


tabs. 


INTRODUCTION 





Text: UP-9973 
Binder: UP-8573 
Easel: UP-8573.1 


To receive both the binder and easel, you must indicate 
both UP numbers to your Sperry representative. 
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GENERAL INSTRUCTIONS 
ENTERING INFORMATION ON A WORKSTATION 


Using the Correct Mode 


To enter commands and respond to messages at the System 80 workstation, you must be in SYSTEM mode. To get 
into SYSTEM mode, press the FUNCTION key, hold it down, and press the SYS MODE key. 


To enter data and output to user-created and system programs (including facilities like EDT) you must be in 
WORKSTATION mode. To get into WORKSTATION mode, press the FUNCTION key, hold it down, and press the WS 
MODE key. 
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For instructions on how to use a terminal other than the System 80 workstation, refer to the discussion entitled 
INTERACTIVE TERMINALS in this manual. 











Using More than One Line to Enter a Command, Response, or Message 


lf you need more than one line (80 characters) of a workstation screen to enter a command, response, or message, 
place a dash (-) as the last character on the line. The dash is a continuation character. It prompts the system to ask you, 
in a message, for further input. Use as many lines of the screen as you need; just place a dash at the end of every line 
except the last one. 


Example: 





1. | COPY MODULE=MYMODULE,FILENAME=MYFILE,VSN=REL®@71 TO MODULE=NEWMODUL , FILENAME=- 
2. | @G? 1893 ENTER CONTINUATION? 


3.) 0G NEWFILE,VSN=NEWVOL,SIZE=10,CONTIG=NO 
1; After keying in almost a full line, add a dash as the last character on the line. Press the XMIT key. 


2: The system asks you for a continuation. 


3. To answer, key in the system message number (OG), enter a space, and enter the rest of the command. 


Press the XMIT key. 











SPERRY OS/3 
INTERACTIVE SERVICES 


UP-9973 





Eee 
COMMAND CONVENTIONS USED IN THIS MANUAL 


a If part of a command or parameter is underscored, it means that only the underscored portion has to be keyed in. 
When a command or parameter is not underscored, you must enter the entire command or parameter. In the = 
following example, ER of the ERASE command is underscored. You must enter at least ER for the command to 
work, but you can enter ERA, ERAS, or ERASE. 


ERASE 


Where ER is the minimum keyin required to successfully use the ERASE command. 


. Parameters printed in lowercase letters designate undefined variables: 
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,VSN=volume serial number 


Where volume serial number is the name of the volume you're working with. 


a Optional parameters are enclosed in brackets: 


Re) 
~ 
p> 
> 
a 
> 


[ ,WRPASS=wr ite password] 





. Alternate choices for a parameter are enclosed in braces: 


pees fee 


RDR “ 
7 Default values are values automatically generated by the system when you do not specify a value for a parameter. 
Default values are shown shaded in each command format: 
3 
,COPI ES=fn oF 
28 
ze 
2 Spaces are indicated by a delta (A) symbol: a= 
3 
COPYAMODULE 7 














LOGON PROCEDURE 


You must begin every workstation session with the LOGON command. To log on, press XMIT and fill in the logon menu 
displayed to you. You may also log on by entering SYSTEM mode and entering the LOGON command as follows: 


LOGON: userid[,acct][,password][,exec-pro] {, BULLETIN={NO | , LOG= {NO | 
YES YES 


[ ,NEWPASS=new- password] 


userid 1-6 alphanumeric characters 
acct 1-4 alphanumeric characters 
password 1-8 alphanumeric characters 
exec-pro 1-8 alphanumeric characters 


To log off the workstation, enter the LOGOFF command: 


LOGOFF 
E There are no parameters entered with this command. 





Update A 
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STANDARD TERMINAL DIALOG FOR ICAM TERMINALS 


If you are using a remote terminal as a workstation, you must connect the terminal to ICAM (Integrated Communications ~ 
Access Method) before you log on. You connect the terminal to ICAM with the following command: 


SSSONAXXXXYYVYY 
XXXX Specifies the logical name of your terminal. 
yyyy Specifies the logical name of the program you are signing on to use. 


After entering the $$SON command, you will receive a message informing whether or not your sign-on attempt was 
successful. 
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After finishing your workstation session and logging off, you terminate your communications link with ICAM by issuing 
the following command: 


SSSOFF There are no parameters entered with this command. 


oO 
~ 
D> 
S 
a 
a) 





RUNNING JOBS 
CHANGING JOB SCHEDULING 


The following commands are used to run jobs from the workstation and change the scheduling for execution of those 
jobs. 





FILE Command 


FILE (((did],label))A} f:alt-filename 
acs | alt-filename, (RES 
RUN 
vsn 
:/alt-filename,[((RES)],write-pass 
RUN 
vsn 


The FILE command files jobs and job control procedures (jprocs) into the permanent job control stream library file 
(SY$JCS) or into an alternate SAT library file. 














f-o) 
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RUN Command 


salt-filename 

s/alt-filename, (RES 
RUN 
vsn 







se a 
CRDR, Label) 


:/alt-filename,[{RES)],read-pass 
RUN 
vsn 
7 (PRE )\.b ctimel] +(d1 [,key-1=val-1,...,key-n=val-n] 
HIGH F 





LOW d9 


The RUN command enables you to execute user jobs from the workstation. The command causes the job control stream 
associated with your job to be read, expanded, and scheduled for execution. The RUN command is used when an input 
device, either a data set label diskette or the input spool file (RDR), is required. 


e 














Update B 
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RV Command 





RVA jobname [(new-name) ]] f:alt- filename ,(PRE [timelf+/a1 
:/alt-filename, (RES HIGH 
RUN : 
vsn LOW a 
:/alt-filename,[ (RES) |,read-pass 
RUN 
vsn 


[,key-t=val-1,...,key-n=val-n] 


The RV command enables you to execute user jobs from the workstation. The command causes the job control stream 
associated with your job to be read, expanded, and scheduled for execution. The RV command is used when there is no 
input device needed. 




















10 


SPERRY 0S/3 
INTERACTIVE SERVICES 


UP-9973 


Update B 





SI Command 


ey aka ea ahd 
CRDR, Label) 


“{:alt-filename ; (PRE Ctimelf4/a1 
:/alt-filename,{RES : 
RUN d9 

vsn 





: falt-filename,!/ (RES )],read-pass; 
RUN 
vsn 


The SI command enables you to run jobs previously saved in the expanded state. The Si command is used when 
embedded data in the job contro! stream is to be replaced. 
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SC Command 


SCA jobname [(new-name)]| f:alt-filename , (PRE [time} fF 2/q1 
:/alt-filename, (RES HIGH : 

RUN NOR 

vsn LOW 





d9 


: falt-filename,[{ RES) ],read-pass 
RUN 
vsn 


The SC command enables you to run jobs that you have previously saved in their expanded state. The SC command is 
used when the job control stream does not require an input device to replace embedded data. 














i2 
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EXECUTE Command 


EXECUTEAprogram-name 


The EXECUTE command enables you to run programs in an interactive job environment. 


To use EXECUTE, you must first run the super-set job control stream that incorporates the program you want to use. 








ULD Command 





ae ea ves le CH 
NOPRINT SAVE 


The upline dump command enables a UTS 400 user to get a dump of the terminal’s memory. A user can choose to print 


or save the dump file. 
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DLOAD Command 


DLOADA{program-name 
/OFFLINE 


The DLOAD command allows a UTS 400 terminal user or a UTS 40/40D workstation user to downline load a program 
to terminal memory. Any program you load using the DLOAD command must reside in the $Y$LOD library. 








UNLOAD Command 
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UNLOAD 


The UNLOAD command frees devices that were allocated to a downline-loaded program. 
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BEGIN Command 


Rescheduling of All Jobs or All Jobs on a Particular Job Queue: 


BEGINAJBQ[, 





H 
N 
Pp 
L 


The BEGIN command reinstitutes scheduling of jobs deferred by the HOLD command. You may reschedule individual jobs 
initiated under your user-id, all of your jobs present in a particular queue, or all of your jobs (all those initiated under your 


user-id). 








Rescheduling of an Individual Job: 


BEGINAj obname 
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HOLD Command 


Holding All Jobs or All Jobs on a Particular Job Queue: 


HOLDAJBQ[, 





The HOLD command permits you to defer scheduling of jobs initiated under your user-id. You may hold individual jobs 
initiated under your user-id, all your jobs present in a particular queue, or all of your jobs (all those initiated under your 


user-id). 


Holding an Individual Job: 


HOLDAj obname 
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CHANGE Command 


CHANGEAj obname, (H 
N 
P 
L 


The CHANGE command permits you to change the scheduling queue in which your job is residing. 
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DELETE Command 














Deleting All Jobs from One or All Job Queues: Deleting A Specific Job: F 
DELETEAJBQ,(A)[,LOG] DELETEAj obname[,LOG] 
wy 
3 
ae 
Ba 
zs 
no 
De 
= 
The DELETE command permits you to remove jobs from scheduling queues. Jobs deleted will not be executed. You may = 
remove single jobs (initiated under your user-id), all your jobs on a particular queue, or all your jobs on all queues. 
~m 
= 
i 
a. 
= 











DISPLAY JBQ Command 


DISPLAYAUJBQ, (# 


-T vz = 


The DISPLAY JBQ command permits you to display, on the workstation screen, the contents (names of jobs) of each 
scheduling queue. 
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CONTROLLING JOBS 
The following commands permit your workstation to act aS a minisystem console to control those jobs initiated or Ss 
running under your user-id. You may only control jobs initiated or running under your user-id. 
fa 
CANCEL Command ae 
~~ Of 
Ba 
CANCELAjobname f, {D ] zy 
[ad 
N az 
wma 
E 
The CANCEL command enables you to immediately halt processing of a job; the currently executing job step is not 7 
completed. You may specify whether or not you want a dump taken when you enter the CANCEL command. 
R 
B 
a 
PE) 








a ee 


CONNECT Command 





-CONNECTAjob[, filename] = 


The CONNECT command is used to connect the WORKSTATION mode of your workstation to a job running on the 
system. You connect to a job at any time while it is running. 











DISPLAY JS Command 
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DISPLAYAJS[, jobname ] 


The DISPLAY JS command enables you to obtain information about jobs initiated under your user-id. You receive 
information about the status of your job, whether it is on a scheduling queue, or executing, and if not executing, why 
not. 








UP-9973 








FREE Command 


FREE 


The FREE command permits you to manually disconnect a workstation from a job. When this command is issued, the 
WORKSTATION mode of your workstation is disconnected from the program to which it was connected. 








PAUSE Command 


PAUSEAj obname 


The PAUSE command permits you to suspend processing of a job. You may enter the PAUSE command at any time, 
and job processing is immediately suspended. Use the GO command to restart job processing. 














22 


SPERRY 0S/3 
INTERACTIVE SERVICES 


UP-9973 


 _— eee 





GO Command 


GOAjobname[,nn] 


The GO command reactivates jobs suspended by the PAUSE command or by certain statements within the job control 
stream associated with the suspended job. 








STOP Command 


STOPAj obname 


The STOP command enables you to terminate a job at the completion of the currently executing job step. 
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CONTROLLING SPOOLING 


The following commands allow you to control the processes of input and output spooling for your job. 
For your convenience, the spool file directories are reproduced here: 





File Function 


Makes all directories accessible to the 
command in which it is specified 


Indicates that the file referenced is a job 
log file 


Indicates that the file is to be output to 
either a card punch or a diskette 


Indicates that the file is to be output to 
a printer 


Indicates that the file was originally 
from a card reader or diskette 
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DISPLAY Command Obtaining information about Active Spool Files: 











<< 
DISPLAYZACT [, [,ACCT=acctno 3 
as 
[,CART=cartridge-name] [,DEV=(770 “ 
776 ae 
™. Of 
789 Ba 
> 
[,FILE=filename]{,FORM=formname][,JOB=jobname]{,STEP=stepno] = 
a. << 
-= 
The DISPLAY ACT command permits you to obtain information about spool files being created. ~ 
Be 
bad 
a 
— J 














DISPLAY Command Obtaining Information about Completed Spool Files: 


DISPLAY’ SPL [Gf ALL [,ACCT=acctno] 
LOG 
PRINT 
PUNCH 
RDR 


[,CART=cartr idge-name] | ,DEV=( 770 
(76 
789 


[,FILE=filename][,FORM=formname][,JOB=jobname][,STEP=stepno] 


The DISPLAY SPL command permits you to obtain information about completed spool files. 
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HOLD SPL Command 


HOLD..SPL, (ALL [,ACCT=acctno][,BNUMB=binary jobno] 
2RINT 
PUNCH 
LOG 
RDR 
[, CART=cartr idge-name] [, DEV= 770 
776 
789 


[,FILE=filename]{,FORM=formname][, JOB=jobname][,STEP=stepno] 


The HOLD SPL command permits you to place files in a hold state, unavailable for processing. 
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BEGIN SPL Command 


BEGIN. SPL, (ALL [,ACCT=acctnoJ][,BNUMB=binary jobno] 
LOG 
PRINT 
PUNCH 
RDR 
[, CART=cartridge-name] (,DEV=(7790 
776 
789 
[,FILE=filename]{,FORM=formname][,JOB=j obname][,STEP=stepno] ie | 
NO epee i> 


The BEGIN SPL command releases spool files held by a HOLD SPL command. Entering this command also loads . 
output writer to print the file as soon as a printer becomes available. 
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Update 














DELETE SPL Command iD 
DELETE. SPL,/ALL [,ACCT=acctno][,BNUMB=binary jobno] as 
LOG 
PRINT 
PUNCH 2 
Q 
RDR os 
: Ba 
[, CART=cartridge-name] [,DEV=(770 — 
776 eas) 
wo 
789 re 
= 
L,FILE=filename][,FORM=formname] [, JOB=jobname[],STEP=stepno] 
The DELETE SPL command enables you to delete files from spool queues. You may delete completed files only — files 
being created may not be deleted. a 
re 
a 
> 




















CHANGE SPL Command 


CHANGEASPL, (ALL 
LOG 
PRINT 


L,modifier-1 ... modifier-n] 


[, COPIES=nnn] 





29a 
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CHANGE SPL Command (cont) 


,DVC=4 770 


CLASS1 
CLASS2 
CLASS3 


,DVC= AUX, 1D={* | 
user-id 


The CHANGE SPL command permits you to change the device type and/or the number of copies of a spool file. 














29b 
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BRKPT Command 


Se ee eae 
I PU 


,»DEV=(770 [,EILE=filename][,FORM=formname] , JOB=jobname [, HOLD] 
776 
789 


The BRKPT (breakpoint) command closes one or more spool files and makes them available to an output writer for 
printing or punching. The remainder of the file created after the BRKPT command is issued is placed on another file. 
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PR/PU Command 


ee jobno] 
PU 


[,CART=cartridge-name][,FILE=filename] 
[,-FORM=formname][, JOB=jobname] 


The PR/PU command enables you to manually load an output writer to print (PR) or punch (PU) spooled files associated 
with your job. 
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RP Command 


RPALfunction-code][,ACCT=acctno][,BNUMB=binary jobno] 
{, CART=cartr idge-name](,FILE=filename] 


[, FORM=formname][, JOB=jobname] 


The RP command enables you to manually load an output writer to print to an auxiliary printer. To use auxiliary printers, 
you must have generated your system to use auxiliary printers and directed your print files to an auxiliary printer prior to 
the time your system prints your print files. RP alone will not direct printing to an auxiliary printer. 














UP-9973 
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UTILITY COMMANDS 


The following commands permit you to perform utility functions, such as copying files, allocating files, scratching files, 


and obtaining status information on various aspects of your OS/3 interactive processing system: 





ALLOCATE Command 


ALLOCATEA ei \eree tse) filename [, RDPASS=password[ ],WRPASS=password] 
MI ‘filename' 
"filename” 


,VSN=volume ica (7792 eines a 
NO 4 


(continued) 
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ALLOCATE Command (cont) 


The ALLOCATE command permits you to allocate space for files interactively, without the need for job control 
statements. You may allocate SAT and MIRAM files using this command. 


NOTE: 
When allocating space on diskettes: 
a If the diskette is recorded in data-set-label (DSL) mode, give the SIZE= and INC= parameters in blocks. 


r] If the diskette is recorded in format-label (FL) mode, give the SIZE= and INC= parameters in cylinders. 
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ASK Command 


ASKA[user-id],'text! 


The ASK command enables you to ask questions of other workstation users or the system operator. The command 
displays your question to the other user, accepts the reply, and returns the reply to you. 


BRKPT LOG Command 
BRKPTALOG [, OUT=(TAPE [,HOLD] 


DISK 
DISKETTE 


The BRKPT LOG command enables you to close a workstation log file and make it available to the output writer for 


printing before you r off the workstation. 
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COMMENT Command 


$ ‘filename! 
“filename” 


Baa a | filename 


[ ,RDPASS=password] [ ,WRPASS=password] , VSN=volumeAtext 


The COMMENT command enables you to put a comment in a library module header or replace an existing comment on a 
library module header. Comments may be up to 30 characters long. 
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COPY Command 


Copying SAT or MIRAM Library Modules: 


Byrn ed eng ees es) [eee ee filename 


$ ‘filename! 
“filename” 
[ ,RDPASS=password], VSN=volumeATOAMODULE=modul ename fas ae | 
g 
,EILENAME= (filename [,ROSZ=n[],WRPASS=password],VSN=volume 
'filename' 
“filename” 





—— 


— ee dee age 
1 No 


The COPY command enables you to copy files and, in the process of copying, to alter the format of a file. 
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COPY Command 


Copying MIRAM Data Files: 


COPYAFILENAME=( filename ica asad KEYNO Ay \| 
® 






'filename' 
“filename” 
DEVICE=(did ATOAFILENAME=(filename )[,WRPASS=password] 
i : 'filename' 
Ob “filename” 


,VSN=volume cane Hae , INC={n) ][, KEYNO= | 2 
NO * \e 





* (continued) 
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COPY Command (cont) 
Copying MIRAM Data Files (cont): 


[,SIZE=n] aes Suse feeere FEX)][,RCSZ=n] [, EXTEND= (YES: 
NO NO VAR NO 


[,BESZ=n] pee ; DEVICE=(did A[NUMBER][,HEX][,WAIT] 
256 DISK 
BISKETTE 


The COPY command enables you to copy files and, in the process of copying, to alter the format of a file. 
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COPY Command 
Copying Spool Files: 


2 

COPYA[ JOB=jobnamej|,HOLD=(L » EI LENAME=( filename [,ACCT=acct] ,QUEUE=(LOG ,ALL=/fYES i 
N ‘filename! PRINT ' be | 

Y “filename” PUNCH 3 

RDR oe 

aie nas ena ,EILENAME=(filename , QUEUE={ PRINT Be 

@ Y ‘filename’ PUNCH ae 

“filename” RDR se 

= 


A{NUMBER][,HEX][,WAIT] 


The COPY command enables you to copy files and, in the process of copying, to alter the format of a file. 
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COPY Command 


COPYA[FILENAME= (filename 
‘filename! 
“filename” 


,BKNO=( YES)] ATOA 
NO 


Copying Tape Files: 


a a aaa 
TAPE 


FILENAME=( filename a aad } 


'filename' 
“filename” 


ae , EXTEND=(¥ES 
NO: NO 





TAPE 


! 
e 





(continued) 
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COPY Command (cont): 


Copying Tape Files (cont): 


NO FIXBLK 
VARUNB 
VARBLK 
UNDEF 


{,BFSZ=n] Faas | 7 RCFM=/#EXUNB YL, RCSZ=nJA[NUMBER ][ ,HEX][, WAIT] 


The COPY command enables you to copy files and, in the process of copying, to alter the format of a file. 
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ee a ee mee 





COPY Command 














Copying Unit Record Files: 
aes 
COPYADEVICE= (did ,FILENAME= (filename ,VSN=volumeATOADEVICE=/did 
DISKETTE ‘filename' DISKETTE 
RDR “filename” PRINT A 
PUNCH n= 
Ba 
ze 
[,RCSZ=n] , FILENAME=( filename ,VSN=volumeA[NUMBER][,HEX][,WAIT] aa 
aq 
'filename' me 
“filename” = 
The COPY command enables you to copy files and, in the process of copying, to alter the format of a file. a 
mn 
a 
= 








DEFKEY Command 


DEFKEYA{F#nn),{'command string' 
MW “command string” 


The DEFKEY command lets you assign any interactive command to a function key or the MESSAGE WAITING key. 








DEFKEY (delete) Command 


DEFKEYAJF#Hnn 
MW 


To free a function key or the MESSAGE WAITING key from a command assignment, you use the delete form of the 
DEFKEY command. The delete DEFKEY command is exactly like the DEFKEY command, minus the command string. 
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DEFKEY DISPLAY Command 


DEFKEYADISPLAY 


The DEFKEY DISPLAY command displays your function key and MESSAGE WAITING key assignments. 








DISPLAY LOG Command 
DISPLAYALOG 


The DISPLAY LOG command gives you a 1-line report on the status of your workstation log file. The display shows the 
number of workstation lines used since you logged on. 
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EDT Command 


EDTA[ initial command] 


The EDT command permits you to initialize the general editor. 
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ENTER Command 


To Run a Command Stream from a Library File: 


ENTERAMODULE=modul ename |, TYPE={module- type} | ,FILENAME=(filename 
es: 'filename' 
“filename” 


[,RDPASS=password],VSN=volume 


The ENTER command permits you to enter a series of workstation commands as a batch processing job. Sessions may 
be entered from a card reader, tape, diskette, spooled file, or library file. Output from the job is always directed to the 


printer. You may enter any workstation command except those directly affecting the workstation device, such as 
SCREEN. 
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ENTER Command 


To Run a Command Stream from a Spooled File: 


Speyer et , FILENAME= (filename QUEUE=RDR 
‘filename! 
“filename” 


The ENTER command permits you to enter a series of workstation commands as a batch processing job. Sessions may 
be entered from a card reader, tape, diskette, spooled file, or library file. Output from the job is always directed to the 


printer. You may enter any workstation command except those directly affecting the workstation device, such as 
SCREEN. 
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9 Eee 


ENTER Command 





To Run a Command Stream from a DSL Diskette: 





for] 
7s 
ENTERA] FILENAME= (filename [, RDPASS=password],VSN=volume] ,DEVICE=fdid 
‘filename! DISKETTE 
“filename” 


The ENTER command permits you to enter a series of workstation commands as a batch processing job. Sessions may 
be entered from a card reader, tape, diskette, spooled file, or library file. Output from the job is always directed to the 
printer. You may enter any workstation command except those directly affecting the workstation device, such as 
SCREEN. 
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ee Vv 





ENTER Command 


To Run a Command Stream from a Tape: 


TAPE 


ENTERA|FILENAME= (filename [ ,RDPASS=password],VSN=volume |, DEVICE={did 
'filename' 


"filename” 


The ENTER command permits you to enter a series of workstation commands as a batch processing job. Sessions may 
be entered from a card reader, tape, diskette, spooled file, or library file. Output from the job is always directed to the 
printer. You may enter any workstation command except those directly affecting the workstation device, such as 
SCREEN. 
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ENTER Command 


To Run a Command Stream from a Card Reader: 





2 
ENTERA DEVICE= at 
RDR 

The ENTER command permits you to enter a series of workstation commands as a batch processing job. Sessions may a 
be entered from a card reader, tape, diskette, spooled file, or library file. Output from the job is always directed to the Cae 
printer. You may enter any workstation command except those directly affecting the workstation device, such as ee 
SCREEN. se 
ae 
Oa 
po 
= 
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ERASE Command 


Erasing a Library Module: 


ee are 


[ ,WRPASS=password] ,VSN=volume 


s 


‘filename' 


eee filename 


“filename” 
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ERASE Command 


Erasing Library and MIRAM Data Files: 


ERASEAFILENAME= (filename [,WRPASS=password], VSN=volume 
'filename' 
“filename” 


The ERASE command permits you to delete library and data files, as well as library modules. Before executing takes 
place, the ERASE command double-checks with you to make certain you want to erase a file. This guards against 
inadvertent erasures. 
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FSTATUS Command 


ESTATUSA[MODULE=modulename] |, TYPE={module-type} |, FILENAME=( filename 
s 'filename' 


“filename” 
[, RDPASS=password],VSN=volumeA[LONG ] 


The FSTATUS command permits you to interactively obtain information about files and their contents. You may 
reference only library file modules. 
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HELP Command 


HELPA {command 

message-no 

keyword-parameter 
The HELP command permits you to obtain information about how to use various workstation commands and their 
parameters and how to respond to error messages from the system. Entering HELP and a command message number or 


keyword parameter produces a display explaining the command, message, or parameter. You may not enter an 
abbreviated form of the command or parameter. 








MENU Command 


MENUA |{menu-name] [, (filename, vsn 


SYSEMT [, rl 
vsn 


The MENU command displays either a standard system menu or a user-created menu. 
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PRINT Command 
Printing an SAT or MIRAM Library Module: 


PRINTAMODULE=modul ename coat module- oe ag filename 


s ‘filename! 
“filename” 
[, RDPASS=password],VSN=volume Giaee*| aaatc [,NUMBER][,HEX][,WAIT] 
4 


The PRINT command enables you to make a printed copy of a library file or module, a spool file, a MIRAM file, a tape 
file, or a unit record file. PRINT can run as a background job to allow you to use the workstation for other functions 
while the file is being printed. 
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PRINT Command 


Printing a MIRAM Data File: 


PRINTAFILENAME= (filename areerbecenengiere erage tere 


'filename' @ 
“filename” 
uae i ;DEVICE=(did A[DIRECT][,NUMBER][,HEX][,WAIT] 





DISK 


The PRINT command enables you to make a printed copy of a library file or module, a spool file, a MIRAM file, a tape 
file, or a unit record file. PRINT can run as a background job to allow you to use the workstation for other functions 
while the file is being printed. 
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PRINT Command 
Printing a Tape File: 


PRINTA[ EILENAME=( filename a a aa ee | 


'filename' TAPE 
“filename” 
ieee ee [,NUMBER][{,HEX][,WAIT] 
NO 


The PRINT command enables you to make a printed copy of a library file or module, a spool file, a MIRAM file, a tape 
file, or a unit record file. PRINT can run as a background job to allow you to use the workstation for other functions 
while the file is being printed. 4 
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PRINT Command 


Printing a Unit Record File: 


PRINTADEVICE=(did ,EILENAME= (filename ,VSN=volumeA[DIRECT][,NUMBER] 
DISKETTE ‘filename’! 
RDR "filename” 


[,HEX][,WAIT] 


The PRINT command enables you to make a printed copy of a library file or module, a spool file, a MIRAM file, a tape 
file, or a unit record file. PRINT can run as a background job to allow you to use the workstation for other functions 
while the file is being printed. 
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PRINT Command 


Printing a Spool File: 


PRINTA[ JOB=j obname] [, HOLD=(L) ][, FILENAME=/(f i lename [,ACCT=acct] 
N 'filename' 
Y "fi lename” 
, QUEUE= /LOG aa ae is COPIES= eae A[DIRECT][,NUMBER][,HEX] 
PRINT ‘i it 
PUNCH 
RDR 


[,WAIT] 


The PRINT command enables you to make a printed copy of a library file or module, a spool file, a MIRAM file, a tape 
file, or a unit record file. PRINT can run as a background job to allow you to use the workstation for other functions 
while the file is being printed. 
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PUNCH Command 


Punching a Library Module: 


PUNCHAMODULE=modul ename Gas ees , EF ILENAME=( filename 


Ss 'filename' 
“filename” 
[, RDPASS=password], VSN=volume fe oe 
1 


The PUNCH command allows you to make a punched-card copy of a library file or module, a spool file, a MIRAM file, a 
tape file, or a unit record file. PUNCH can be run as a background job to allow you to use the workstation for other 
functions while the file is being punched. 











uP-9973 
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PUNCH Command 
Punching a MIRAM Data File: 


PUNCHAFILENAME=(filename ) [,RDPASS=password], VSN=volume feemorfat] 
'filename' 
“filename” 


sit , DEVICE 


The PUNCH command allows you to make a punched-card copy of a library file or module, a spool file, a MIRAM file, a 
tape file, or a unit record file. PUNCH can be run as a background job to allow you to use the workstation for other 
functions while the file is being punched. 





did A{DIRECT][,WAIT] 
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eee 








PUNCH Command 
Punching a Spool File: 
3 
PUNCHAJOB=j obname |, HOLD=(L ,FILENAME= (filename {,ACCT=acct] 
N 'filename' 
Y “filename” Pa 
, QUEUE=/LOG ,ALL={YES ,COPIES=fn pga | a a oF 
WM ul 
PRINT NO 1 @ ee 
eS 
PUNCH BS 
RDR eas 
Zz 
The PUNCH command allows you to make a punched-card copy of a library file or module, a spool! file, a MIRAM file, a 
tape file, or a unit record file. PUNCH can be run as a background job to allow you to use the workstation for other 
functions while the file is being punched. 
3 
s 














PUNCH Command 


Punching a Tape File: 


PUNCHZ.] FILENAME={ filename {,RDPASS=password],VSN=volume Rn 
'filename' TAPE 
"fi lename” 
eee A[DIRECT][,WAIT] 
NO: 


The PUNCH command allows you to make a punched-card copy of a library file or module, a spool file, a MIRAM file, a 
tape file, or a unit record file. PUNCH can be run as a background job to allow you to use the workstation for other 
functions while the file is being punched. 
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IEEE EEE LL ee 


PUNCH Command 





Punching a Unit Record File: 


ae 
PUNCHADEVICE=(did ,FILENAME=(f ilename ,VSN=volumeA[DIRECT][,WAIT] 
DISKETTE ‘filename! 
RDR “filename” 


The PUNCH command allows you to make a punched-card copy of a library file or module, a spool file, a MIRAM file, a 


tape file, or a unit record file. PUNCH can be run as a background job to allow you to use the workstation for other 
functions while the file is being punched. 
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REBUILD Command 


REBUILD 


66 


The REBUILD command restores messages requiring a response or a GO command to your workstation screen. 








RECALL Command 


RECALLA ees 
hh:imm:ss-hh:mm:ss 


The RECALL command lets you display all or part of your workstation log file at your workstation screen. You can view 
selected portions of the log file by specifying a particular time span. Or, you can indicate the number of messages, prior 
to the most current one, that you'd like to see. 
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RECOVER Command 


RECOVERAMODULE=modul ename cas ila ,FILENAME=(filename 
s ‘filename! 
“filename” 


[ ,RDPASS=password][,WRPASS=password], VSN=volume 


The RECOVER command allows you to recover deleted source, procedure, or macro modules in the SAT library. You 
may also use the command to rename modules not deleted. 

















67 


SPERRY 0S/3 
INTERACTIVE SERVICES 


UP-9973 


EE Eee 





REMARK Command 


REMARKAtext 


68 


The REMARK command allows you to enter a comment in a stream of commands. It is used principally in card decks for 
batch processing, but may be used in any situation where a comment needs to be inserted in a command stream. 











RESUME Command 
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RESUME 


The RESUME command enables you to resume execution of a subsystem, such as the general editor or BASIC, that was 
suspended when the workstation entered SYSTEM mode. 
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SCREEN Command 


SCREENA[/SERDI ; (MBPER)] [ XMIT=/ VAR: ,XEER=( VAR , SPEED=/9688 
LOWER CHAN CHAN 4800 Z 





Update B 












ALL ALL 2400 
1200 
600 2 
300 oe 
haamaak DESTRUCT | eatin bet | | aa || , INTENSITY=( NORMAL ahs 
‘ae TRUCT 12 tieaa Ww e6 
REVERSE “es 
= 





[Comes] (ies | Lfeonsr H [ere sorroM 


The SCREEN command enables you to alter certain characteristics of the workstation or terminal you're using. You may 
use the SCREEN command to change different characteristics on different terminals acting as wornstations; consult the 
interactive services commands and facilities user guide/programmer reference, UP-9972 (current version) for further 


information. 
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STATUS Command 


STATUSA[/ TERMINALS 
RESOURCES 
JOBS 
FUNCTIONS 
VOLUMES 
LIMITS 


The STATUS command enables you to obtain information about various aspects of your system, including usage of 
terminals and workstations, numbers of jobs running on the system, system main storage resources in use and available, 
jobs running under your user-id, and which interactive commands and facilities are executing under your user-id. STATUS 
can also give you a listing of the disk, tape, and diskette volumes currently mounted on your system. 
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TELL Command 


TELLA| fuser-id),}'text! 
ALL 


The TELL command enables you to send messages that do not require a response to the system operator or other 
workstation users. 








VTOC Command 


VIOCA['file-prefix', ]VSN=volumeA[ FREE] 


The VTOC command enables you to produce a listing of the files present on a disk or diskette volume. You may list all 
the files on a volume, or only those whose file names begin with a prefix you specify. You may also obtain a listing of 


each free extent available and its size. 
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INTERACTIVE FACILITIES 





INTERACTIVE DATA UTILITIES 


To initialize the interactive data utilities, enter the following command: 


RVAI@DATA[ (new-name)][,,MEM=nnnnn, ][ACT=act-no, ] ieee \] 
® 


Cnew-name) Permits the concurrent use of data utilities. 


MEM=nnnnn Specifies, in hexadecimal notation, the minimum main storage needed to run your data utilities 
job. Default is 8000, (32,767 49). 


ACT=act-no Specifies a 1- to 4-character alphanumeric account number. 
DBG=yY Specifies that data utilities run in the debugging mode, used to provide documentation for 
N reporting a software user report (SUR). 
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JOB CONTROL DIALOG 


To initialize the job control dialog, enter the following command: 


RVAJCSBLD 











SCREEN FORMAT GENERATOR 


Use the following command to initialize the screen format generator: 


RVASF GEN 


There are no parameters associated with this command. 
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USING SCREEN FORMATS IN YOUR PROGRAM 


Use the following job control statement to include formatted screen displays in your programs: 


//{symbol JUSE SFS[, (format-file-lfd-1/format-file-lfd-2)][,initial-screen]|,fnnn 
format-file-id co 
SYSEMT 


[,screen-format-1=alias-1...,screen- format -12=al ias-12] 


ocean -file- a Specifies the LFD name(s) of the screen format file. 
initial-screen Specifies the first format name to be used in behalf of the user program. 


ot Specifies the number of formats to reside in main storage for use with a given file. 


[,screen-format-1=alias-1...[,screen-format-12=alias-12]] 


aliases permitted. More than 12 causes rejection of the job control stream. 





Specifies that a name other than the real name of the format is to be used. Maximum of 12 
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MENU GENERATOR 


Use the following command to initialize the menu generator: 


MENUGEN 


There are no parameters associated with this command. 
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USING MENUS IN YOUR PROGRAM 


Use the following job control statement to include menus in your program: 


//{symbol JUSE MENU [;/menu-file-lfd-1/menu-file-lfd-2\][, initial -menu] 
S¥SFMT /menu-file-lfd-2 
menu- file-lfd-1/S¥SFMF 
menu-file-lfd-1 
SYSPMT 
GAS eee 1=alias-1...,menu-12=al ias-12] 
4 


(continued) 
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USING MENUS IN YOUR PROGRAM (cont) 


menu-file-lfd-1/menu-file-lfd-2 


SYSEMT/menu-file-lfd-2 Specifies the lfd name or names 
menu-file-lfd-1/S¥SFMT for up to two files that will be 

menu-file-lfd-1 searched for the correct menu. 

SYSEMT 

initial -menu Specifies the name of the first or only menu to be used by a program. 

\_ Specifies the number of menus to reside in main storage for use with a given file. 


{,menu- l=alias-1...[,menu-12=alias-12] 
Specifies that a name other than the real name of the menu is to be used. Maximum 


of 12 aliases permitted. More than 12 causes rejection of the job control stream. 
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INTERACTIVE DUMP/RESTORE HARDWARE UTILITY 


The dump/restore hardware utility lets you interactively initiate and control the DMPRST routine from your workstation. 
The DMPRST routine creates backup copies of your program and data libraries on disk, tape (including streaming tape), 


or diskette. 


To initialize the interactive dump/restore hardware utility, enter the following command: 


HU 


There are no parameters associated with this command. 
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BASIC 


BASIC is an interactive programming language you can use from your workstation. To initialize BASIC, enter the 
following command: 


BASIC 


There are no parameters associated with this command. 
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ESCORT 


ESCORT is an interactive programming language that uses English statements to create a program. The ESCORT 
language allows you to generate reports and perform inquiry and update routines through the use of simple, sentence-like 
programs, entered through your workstation. To use ESCORT, log on and enter the following command: 


ESCORT 


There are no parameters associated with this command. 
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GENERAL EDITOR COMMANDS 


The following is a listing of the commands used by the SPERRY Operating System/3 General Editor. 
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a eee 














Command Format Explanation 
EDT Commands 
@ @({line-number [increment] se Sets the current line 
+ €ommand number and increment for 
data and command lines 
~ keyed in at the workstation 
CHANGE @C ['search-string'[*n]]TO 'change-string'[¥*n] Replaces an existing 
string in the current 
work-space file with a 
new string 
COPY @CO [line-range]['search-string'[*n]] Copies lines in the 


TO destination 





current work-space file to 
new line locations without 
deleting the original lines 


(continued) 
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EDT Commands (cont) 
DELETE @D [line-range]['search-string'[*n]] Erases specified lines 
~ and their line numbers el 
from the current work-space 
file 
FIND @FIN 'search-string'[*n] Locates the first occurrence 2 
ao of a string in the work-space os 
file and assigns its corres- pane 
ponding line number to the ze 
variable ? and the column wo 
numbers of the first and last 2 
columns it occupies to z 
[ and ] respectively 
S 
a 
(continued) 5 














EDT Commands (cont) 





FSTATUS ei ainena er nenellprtra merase 
S$ 


‘filename! 
“filename” 
[ ,RDPASS=password], VSN=volume pees lee 


ome baer 


DISK 
DISKETTE 





} 


Creates in the work-space 
file a list of all modules 
contained in a specified 
program library 


(continued) 
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EDT Commands (cont) 

















INSERT @I ‘'change-string'[*n] Inserts a specified string 
into lines in the current 
work-space file 

LIST @L [line-range]['search-string' [*n] JALIMMEDIATE} Prints specified lines 
from the current work-space 
file on the printer 

MOVE @M [line-range]['search-string'[*n] ] Transfers specified lines 

TO destination to new line locations in 
the work-space file and deletes 
the original lines and line 
numbers 

NUMBER @NU 'sequence-string'([*n] {BY increment] Inserts sequence numbers 


into input lines 











(continued) 
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EDT Commands (cont) 





PRINT @P [line-range][search-string[*n] ] Displays specified lines 
from the current work-space 
file on the workstation screen 
PUNCH @PU [line-range]['search-string'[*n]]ALIMMEDIATE]  Reproduces specified lines 


from the current work-space 
file on cards 











(continued) 
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EDT Commands (cont) 








'filename' 


READ GRAMODULE=module-name,FILENAME= filename 
“i lename” 





\ 


A[(KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 


SHOWAf irst-col-no:last-col-no 


Reads a SAT or MIRAM 
library module from disk 
or format label diskette 








(continued) 








87 


SPERRY 0S/3 
INTERACTIVE SERVICES 


UP-9973 








EDT Commands (cont) 





'filename' 


READ eee tera eee 


“filename” 


® DISK 
DISKETTE 


,VSN=volume [ KELEOY n }] poses" (ats 


[,BFSZ=n] [, TRUNC={ YES 
NO 


A[(KEY=start-col-no:end-col-no 
KKEY=start-col-nozend-col-no 


SHOWAf irst-col-no:last-col-no 


1 


Reads a MIRAM data 
file from disk or 
format label diskette 











(continued) 
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EDT Commands (cont) 








READ @RA{ JOB=j obname] [, HOLD={LOG Reads a file from 
NO the spool file 
YES 


‘filename! PRINT YES 


ame filename laa LOG beppenmecce Neer (eet | 
“filename” 


ae 


YES)]4 KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 





SHOWAf irst-col-no:last-col-no 





(continued) 
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EDT Commands (cont) 

















READ @RAF ILENAME=( filename ,VSN=volume Reads a unit record file 
~ on ‘filename! from a data set label 
"filename” diskette or card reader 
,DEVICE={did (ee ad KEY=start-col-no:end-col -no 
DISKETTE KKEY=start-col-no:end-col-no 
RDR SHOWAf irst-col-no-:last-col-no 
@RAF ILENAME=( filename { ,RDPASS=password] Reads a file from 
‘filename! a tape 
“filename” 


,VSN=volume ,DEVICE={did | [,/BKNO=/YES\][ ,TRUNC= 
TAPE NO 





rN KEY=start-col -no:end-col-no 
KKEY=start-col-no:end-col-no 
SHOWAT irst-col-no:last-col-no (continued) 
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EDT Commands (cont) 








READ aR Reads the same module or 
file last accessed through 
a previous @READ or @WRITE 
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command 
i 
READ @RA;Al (KEY=start-col-no:end-col-no Reads the same module or oF 
KKEY=start-col-no:zend-col-no | file last accessed through a Sa 
SHOWAf irst-col-no:last-col-no previous @READ or @WRITE z= 
[valid EDT command] command but read now with WO 
a previous KEY, KKEY, or ie 
= 


SHOW parameter or any 
valid EDT command specified 








UP-9973 


(continued) 














EDT Commands (cont) 








REMOVE 





@REM 'search-string!'[*n] 


Deletes a specified 
string from lines in 
the work-space file 





SEQUENCE a a aa a increment 
* 


Inserts sequence numbers 
into existing lines in the 
current work-space file 





UPDATE 


@U [line-range]['search-string'[*n)]} 


Displays specified lines 
from the work-space file 
one at a time for you 
to edit or change 











(continued) 
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EDT Commands (cont) 





WRITE Dipper ce Weer ee os 
Ss 


‘filename! 
“filename” 


,VSN=volume agua = I) [ a \! ,RCSZ=n] 
YES a 


[,S1ZE=n] pss No ] 
esl 


ieee ator aan eine 






Writes a SAT or MIRAM 
library module to disk 
or format label diskette 















(continued) 
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EDT Commands (cont) 





WRITE 


‘filename! file to disk or format 
“filename” label diskette 
[ ,WRPASS=password] , VSN=volume 


foaea nt ees a) 


,RCSZ=n [, SCSZ= 
{256} 
,DEVICE=(did [,SIZE=n][, EXTEND={ YES)][,BFSZ=n] 
— [pis NO 


Deane ite | Writes a MIRAM data 


DISKETTE 


KEYi=(start-col-no:zend-col-no 
(ober tcp lenosenereo ten’ 2a \. fae: }) 
NDUP. NCHG (continued) 
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EDT Commands (cont) 

















WRITE @WA[ JOB= j obname ] [ HOLD=j NO Writes a file to the 
i aes YES the spool file cy 
,FILENAME= (filename 
‘filename! Pa 
“filename” a 
wv ut 
[,ACCT=acct-no], QUEUE=( PRINT fesetess4oy) Sd 
PUNCH + =o 
RDR = 
2 
B 
Ss 


(continued) 








EDT Commands (cont) 








WRITE (@WAF ILENAME= (filename ,VSN=volume Writes a unit record 
a 2 {)FConane| file to a printer, 
“filename” punch, or diskette 
,DEVICE=(did [-oen= fewxt) co Rcsz=n) 
DISKETTE VAR 
PRINT 
PUNCH 
WRITE @WAFILENAME=(filename  )[,WRPASS=password] Writes a file to tape 
‘filename! 
f filename” 
,VSN=volume, DEVICE=fdid )[,BFSZ=n] [, INIT=f YES peg lt 
—_ TAPEf NO NO f. 
[-2xno= {nes ] ,RCEM=/(#IXUNB) [[,RCSZ=n] 
NO FIXBLK 
VARBLK 
VARUNB 
UNDEF (continued) 
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a a ST RS I ESD 





EDT Commands (cont) 





WRITE aw Writes to the same module 
or file last accessed through 
a previous @READ or @WRITE 
command 
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WRITE @WA;4valid EDT command Writes to the same module 
or file last accessed 
through a previous @READ 
or @WRITE command but 
written now with any valid 
EDT command specified 
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EDT Variable Commands 











ASSIGN @ASAGn=/'string'[*n] Assigns values to EDT 
ia n(x:y) variables 
n[am) 
Gm 
LENC(n) 
DISPLAY @DIA/'string'[*n] Displays a specified 
Nn(xiy) expression or the value 
n{ +m] of a specified expression 
Gm from the work-space file 
LEN(n) on the workstation 
screen 
IF @IF.condition. command Permits an EDT command 


or 


@IF expression relation expression command 


or EDT procedure file 
command to be executed 
based on some condition 
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a 























General Editor Procedure File Commands 
DO. @DO proc-number PRINT Executes a procedure file 
NOPRINT 3 
REVERT 
END (@eE Terminates procedure file g 
definition CE 
. 3 
GOTO @G/ Noes Permits branching within ES 
Label a procedure file ae 
hairs} 
we 
INPUT @INPAfile-parameters PRINT Loads and executes a = 
NOPRINT procedure file 
REVERT 
(continued) s 











General Editor Procedure File Commands (cont) 








NOP @NOPA[ comment ] Enters extra lines for 
branching or comments 
into a procedure file 

PROC @PRO [proc-number ] Begins procedure file 


definition 





RETURN = @RET 


Terminates procedure file 
execution 
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General Editor Directives 




















CHECK @CHEA Determines whether processed 
FON lines are to be displayed 
on the workstation screen 
COBOL aCOB Activates the COBOL editor 
DROP aDR Deletes all lines in 
the entire EDT work-space 
file 
EFP aEFP Activates the error 














file processor 





(continued) 
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General Editor Directives (cont) 





FORMAT @FORMAT parameter-string (for RPGEDT) 
a FORMAT (for COBEDT) 


Used only in conjunction with 
either RPGEDT or COBEDT. 

For information on the @FORMAT 
directive, see the current version 
of the RPG Il editor user guide/ 
programmer reference, UP-8803 or 
the COBOL editor user guide/ 
programmer reference, UP-9106. 





HALT aH 


Terminates the EDT 
session 





RPG RPG 


Activates the RPG Ii editor 
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General Editor Directives (cont) 





SET @Sé [CHAR=tab-character , TABS= columns Defines various parameters 
~ OFF to EDT that collectively 
make up your EDT environment 


[, LINE=length] ee lee renee 
OFF . 


[,ATSIGN=command-trigger][,COLON=range-separator ] 


[, ENCOL=end-column} , BUFFER=f record-size 
OFF 


a pierre 
OFF 


FOLD 8 (if SCRDSPLY=FOLD) 


(eas cine /ROLL=( 15C if SCRDSPLY=TRUNCATE) 
1-15 


(continued) 
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General Editor Directives (cont) 











,MODE=J LINE , LANGUAGE=( FREEFORM ) |[, RECENTRY=f{ SINGLE = 
7 SCREEN fi FORTRAN MULT a 
= COBOL 
RPG 

a 
, SCRFORM=f UNDERLINE oe 
[ss {BURAK | Ba 
ze 
were) 
SYSTEM @SYA{workstation-command] Permits workstation commands ae 
to be issued during = 


an EDT session or 
temporarily returns you 
to system mode 
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General Editor Screen Commands 

BLOCK @BL Displays a free-form screen that 

~~ allows you to switch to block 
mode for entering multiple 
commands or data 

HELP @HEA[error message code] Displays help screens for any 
EDT error messages 

PARAMS @PA Displays a screen showing the 


parameters on the @SET directive 
(those that make up your EDT 
environment) 











(continued) 
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General 


Editor Screen Commands (cont) 





PROMPT @PROMA[EDT command] 


Displays the EDT command menu 
screen or help screens for any 
EDT command (meaning EDT 
commands, modifiers, directives, 
procedure file commands, 
variables, and screen commands) 





RESTORE @RES 


Returns you to the point in 
your EDT session where you 
originally entered a screen 
command 





ROLL @RO 


Displays free-form screens 
showing the EDT work-space file, 
where you can update lines or 
simply view them 
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EFP Commands 








To correct and display COBOL and RPG Il errors and 
FORTRAN 1V errors for one source module at a 
time, use: 


@EF [X]A[program-unit-name]JA 
(error-range]JA['search-string' ] 


To correct and display FORTRAN IV errors for 
compilations that process multiple source 
modules, use: 


@EFASOURCEAsource-module-name,source-file-name,vsn 


Displays errors in your error 
file along with the source 
lines that contain those 
errors. Note that EFP is both 
an EDT directive and an EFP 
command. 








(continued) 
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EFP Commands (cont) 





END 


@EFAEND 


Terminates the error file 
processor 





SUMMARY 


(@EFASUM 


Displays an error file summary 
for the module you're correcting 
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RPG Il EDITOR 
COBOL EDITOR 


The RPG Il and COBOL editors are actually subeditors of EDT. Therefore, you must first activate the General Editor before 
you can use a language editor. Once in a language editor session you can use any of the EDT commands. 
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RPG Il EDITOR 


To activate the RPG Il editor, key in the following command: 


EDT A@RPG 


The following are commands you use in conjunction with the RPG II editor: 


Command Format 


Explanation 





FORMAT @FO specification-type 
@FO specification-type, format -type 
@FO ,format-type 
@FO ,format-type,CMD 


Allows you to change the display 
format type and/or switch the RPG Il 
editor from the update mode to the 
create mode. 





HALT @H 


Terminates the RPG Il (and 
EDT) session. 
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COBOL EDITOR 


To activate the COBOL editor, key in the following command: 
EDTA@COBOL 
The following are commands you use in conjunction with the COBOL editor: 


Command Format 


Explanation 





FORMAT @FO parameters 


Changes the display format type. 





HALT @H 


Terminates the COBOL editor (and 
EDT) session. 
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The following is a list of special commands to perform DDP functions. 


Command 


DDP COMMANDS 


Explanation 





DDP Commands 





DDPACREATEAFILE= (eae ::]fite-id 
kocal Rost -Fd 

Deiaieuacra nnnnnnnnny]f-ADENSITY=/200 

256 }] 556 

800 


1600 
6250 











The CREATE command: 


Establishes a file on a 
receiving host 

Allocates space for the file 
Catalogs the file in your 
online system catalog 

Records the file in the 
volume table of contents 
(VTOC) of the volume at 

the remote host on which the 


file is created 


(continued) 
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DDP Commands (cont) 





\DEVICE_CLASS=(®TSK AFILE_TYPE=(SEQUENTIAL 
TAPE INDEXED 
DISKETTE LIBRARY NOTE: 
UNDEFINED The default for INCREMENT 


[ SINCR ERENT SHES nnnannnnnn ] AINITIAL_SIZE=fnnnnannnnn SIZE and INITIAL SIZE 
B eyl \\ BS cyt is three cylinders. 
lf more or less than three 





KEYP_fn\]=/size, locationl *| RBEDUBLEER cylinders is needed, 
: NO DUPLICATES the size must be entered 
in number of blocks 
wh CHANGE (nnnannnnonn). 
NO. CHANGE: 
APARITY=f0DD } “RECORD _FORM=[FIXED 
EVEN VARIABLE 
UNDEFINED 
(continued) 
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DDP Commands (cont) 





pene es se ariasas \] 
256 CATALOG 








DDPACOPYAFROM= [= 


eral 


AELEMENT TYPE=(S¥MBO 
RELOCATABLE 
ABSOLUTE 
MACRO 
PROC 
COMPILED JOB 
SCREEN FORMAT 





a ad 


semaines (YT [eet ination-tile-id 

















The COPY command permits 
you to copy a file or 
module from one system to 
another. You may copy a 
file or module from one 
remote system to another, 
from your local system to 

a remote system, or vice 
versa. You may also use the 
COPY command to copy a file 
within your local system. 


(continued) 
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DDP Commands (cont) 





SKEY -a}}- Size,location [.\fDUPLICATES } 
NO DUPLICATES 


J.J CHANGE 
NO CHANGE 
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MODE= fear lege EOF ] Pa 
WAIT SOF z 
[iar a 

TRANSLATE={ASCII 

| {Esco I e 
NONE 
eee host-id a file-id The PURGE command allows 
a you to physically remove Ne) 
a file, and all references z 
to it, from a host system. — (continued) =) 














INTERACTIVE SERVICES 





Se ey ge ge 























DDP Commands (cont) 
DD ASUR TATE (Sg ste ae coe idles [iene The SUBMIT command allows you e 
Local-host-id to send a file of job control = 
: streams to a host system for 
/\ELEMENT de cr erira; \] execution. You can also use it 
[ . COMPILED JOB to initiate a file of job 
7 control streams already at the i] 
eas Ssanuenaecn S| host system or to bring a job os 
local -host-id control stream to your local Ba 
system for execution. ES 
ores soe S 204 ae 
DDPACANCELAJOB= posse ::]jobname The CANCEL command allows ee 
Locat — you to terminate a job z 
either executing or scheduled 
apes DISCARD ee host-id for execution on a host 
DELIVER local -host-id system. 
DDPASUBMITAREQUEST=statement on ee The SUBMIT REQUEST command a 
Local-hast-id allows you to send a state- aD 
ment, such as an operator (continued) s 














DDP Commands (cont) 








or interactive command, to 

a host system. The following 
statements (commands) cannot 
be used: DISPLAY, DELETE, 
BREAKPOINT, FILE, IN, SU, 
TU, PD. 











DDPASTATUSA {COMMAND=work - order -number 






FILE {r -id jeans 
[keyword parameter] 
HOST=host - id 


JOB= js lopiees 
a 





host-id Jes user-id 
Ocal-host- id 











The STATUS command enables 
you to obtain information 
about: 
@ Commands entered 
® Host systems in your DDP 
system 
@ Jobs you have submitted 
Files in your DDP system 
@ Other users on your 
DDP system 
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DDP Commands {cont} 





DDPATALKAMESSAGE='string' 


aaaelt ; 








OPERATOR) [AWAIT } 
user-id 


The TALK command allows you 
to send a message to a 
remote operator or user. 
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INTERACTIVE TERMINALS 


OS/3 interactive services can be accessed through four types of terminals: the workstation (UTS 20/20D or UTS 
40/40D), the System 80 console workstation, the UNISCOPE 100 and 200, and the UTS 400. The following table 
shows the different procedures used to access interactive services through these different types of terminals: 


NOTE: 


You do not need to enter the $$SON command to log onto either a workstation or the System 80 console workstation. 
However, some system programs such as the Information Management System (IMS) require the use of ICAM to connect 


to workstations and terminals. In such cases, log on normally and then enter $$SON to sign onto IMS or other similar 
programs. 
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UNISCOPE System 80 
Workst 


————————— EE 





| LOGON 


SYSTEM Press FUNCTION Press MESSAGE Press MSG Press FUNCTION 
mode and SYS MODE keys. | WAITING key. WAIT key. and SYS MODE keys. 


WORKSTATION | Press FUNCTION Press MESSAGE Press MSG WAIT key. |/Press FUNCTION 

and WS MODE keys. | WAITING key. Then Then press W then S_ |and WS MODE keys. 
press W then S keys; |keys; then press 
then press TRANSMIT.jTRANSMIT. 


Press MESSAGE Press F1-F22 
WAITING key. Then UPPER FUNCTION 
press F1—F4; for when required. 
rest, press F, the 
pound symbol (#), 
then 5-22. 












































Press FUNCTION 
and F1-F22 keys. 


Function 
keys 


Press FUNCTION 
and F1—F22 keys. 











(continued) 
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5 UNISCOPE System 80 
da sai Console Workstation 


Function To simulate the 

keys MESSAGE WAITING 

(cont.) key, enter system 
mode by pressing the 
MESSAGE WAITING 
key, then type MSG. 


Message SYS MSG MESSAGE MESSAGE SYS MSG 

waiting displayed on WAITING light WAITING light displayed on 
indicator indicator line is lit and the audible is fit and the audible indicator fine 
alarm sounds. alarm sounds. 


Save and YES NO NO YES 
restore SYS 
mode lines 
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FUNCTION KEY SUMMARY 


This summary provides an overview of the function keys used by interactive services and the various interactive facilities. 


Software ; 
bisa a 


F15] Informs the system you have no more data to input from the workstation (end of file) 


F17] Temporarily halts the workstation display. (See F19.) 


Restarts workstation display after it has been temporarily stopped using F17 or when the screen 
is full of data 













Interactive 
services 








mn 
= 
ice) 






General 
editor 






Suppresses any printing options associated with a command. (Same as F 18) 


Terminates processing of a command 


Displays a screen showing the parameters on the @SET directive, or those that make up your 
EDT environment. F3 is the same as issuing the PARAMS screen command. 


F3 


= 
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Softw. 
twats Function 
Component _ 
General Displays a freeform screen through which you can switch to block mode for entering multiple 
: ™N 
editor (cont) commands or data. F4 is the same as issuing the BLOCK screen command. = 


5 Displays freeform screens, showing the EDT work-space file where you can update lines or 
simply view them. F5 is the same as issuing the ROLL screen command. 
Displays help screens for any EDT error messages. F6 is the same as issuing the HELP screen 


command. 


F121 Shows a previously displayed additional help screen for a specific command when that command 
requires several help screens to fully describe it. 


Displays the EDT command menu screen and help screens for any of the EDT commands. F13 is 
the same as issuing the PROMPT screen command. From a help screem, F13 also lets you see 
subsequent help screens needed to fully describe the command. 


SPERRY 0S/3 
INTERACTIVE SERVICES 


ee Returns you to the point in your EDT session where you originally entered a screen command. 
ae is the same as issuing the RESTORE screen command. 
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Software 
Ke 
ee or 


General 
editor (cont) 


Screen 
format 
services 


F15] Recognized as EOF indicator. Halts an EDT session run in batch mode or produces an error 
message in interactive mode. 


F18 | Suppresses printing option associated with a command. (Same as F1) 


F19]| Restarts workstation display after it has been temporarily stopped using F17 or when the screen 
is full of data 


Returns the screen format generator to the HOME screen. Returning home deletes all work 
done up to that point. 


Causes the screen format generator to breakpoint the spool file to a printer. All records currently 
in the spooled printer output are directed to a printer. Records added to the spool file after the 
breakpoint are held until a subsequent breakpoint is requested or until the end of the job. 





Displays a HELP screen appropriate to the step you're at when generating a screen format. (See 
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Software 
Component 


Screen 
format 
services 
(cont) 







F14{ Removes the HELP screen displayed by using F13; returns the screen format generator to the 
point it was at before display of the HELP screen. 
















Indicates end of input data 













[16] Indicates input data cannot be entered propery | Indicates input data cannot be entered Indicates input data cannot be entered property | 


F20 | Restores the screen to its original contents for the current pass if it has inadvertently been 
destroyed. 


Pauses or terminates execution of a BASIC program. When no I/O operation is in progress, the 
system displays the message: 





EXECUTION PAUSED AT LINE xxxx CONTINUE (Y,N)? 
Key in Y to continue (resume) execution. Key in N to terminate the program. 


r If a BASIC program is requesting output, you must press XMIT after pressing F1 to display 
the above message. 





125 


SPERRY 0S/3 
INTERACTIVE SERVICES 





UP-9973 





Software 





Component 


BASIC 
(cont) 


ESCORT 


ef met 





wo 
Fl jo lf the BASIC program is sending output, the workstation screen must be full of data for F1 = 
to be recognized. Press F19 to display the above message. 
See F1. 
Signals the end of input and returns to master menu. (Used only with the structure processor) <2 
”n 
Oo 
Cancels display output. (Used only with the structure processor) a 
5 
F3 | Cancels the current screen and returns to the previous screen. (Used only for program and 
tutorial modes) 
F4 Structure processor: aborts structure and returns to menu 
Program mode: ends free-form input and returns to previous menu 
es 
Run-time processor: terminates program and returns to caller . 
= 








INTERACTIVE SERVICES 





This index alphabetically lists each interactive services command and its page number. 


Command 


ALLOCATE 
ASK 
BASIC 
BEGIN 

JBQ 


jobname 
SPL 


Page No. 
33 
35 


79 


15 
15 
28 





Command 


BRKPT 


BRKPT LOG 


CANCEL 


CHANGE 


CHANGE SPOOL 


Page No. 
30 
35 
20 
17 


29a 





COMMAND INDEX 


Command 


COMMENT 


CONNECT 


COPY 


library modules 
MIRAM data files 
spool files 

tape files 

unit record files 


Page No. 
36 


21 


37 


40 
4} 
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Command 


DEFKEY 
(delete) 
DISPLAY 


DELETE 
JBQ 
jobname 
SPL 


DISPLAY 
ACT 
JBQ 
8 
LOG 
SPL 


Page No. 


44 
45 


18 
18 
29 


25 
19 
21 
45 
26 





Command 


DLOAD 


EDT 


ENTER 


ERASE 


card reader 
diskette 
library file 
spooled file 
tape 


library and MIRAM 
data files 
library module 


Page No. 


14 


46, 82 


51 
49 
47 
48 
50 


93 
52 





Command 


ESCORT 


EXECUTE 


FILE 


FREE 


FSTATUS 


GO 


HELP 


Page No. 


80 


13 


22 


54 


23 


95 
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Command 


HOLD 
JBQ 
jobname 
SPL 
HU 
I@DATA 
JC$BLD 
LOGOFF 


LOGON 


MENU 





Page No. 


16 
16 
27 
78 
72 


73 


55 


Command 


MENUGEN 


PAUSE 


PR/PU 


PRINT 
library module 
MIRAM data file 
spool file 
tape file 
unit record file 


Page No. 


ik) 


22 


31 


56 
57 
60 
58 
59 





Command 


PUNCH 
library module 
MIRAM data file 
spool file 
tape file 
unit record file 
REBUILD 
RECALL 
RECOVER 
REMARK 


RESUME 


Page No. 


61 
62 
63 
64 
65 
66 
66 
67 
68 


68 
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Command 


RP 

RUN 

RV 

RV I@DATA 
RV JCS$BLD 
RV SFGEN 

SCREEN 


SFGEN 





Page No. 


32 


10 
72 
73 
73 
69 


73 


Command 


SI/SC 


STATUS 


STOP 


TELL 


ULD 


UNLOAD 


VTOC 


Page No. 
11, 12 
70 
23 
71 
13 
14 


71 
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